# Q. What is this file?
# A. This file contains options which allow you to configure your multiworld experience while allowing
#    others to play how they want as well.
#
# Q. How do I use it?
# A. The options in this file are weighted. This means the higher number you assign to a value, the
#    more chances you have for that option to be chosen. For example, an option like this:
#
#    map_shuffle:
#      on: 5
#      off: 15
#
#    Means you have 5 chances for map shuffle to occur, and 15 chances for map shuffle to be turned
#    off.
#
# Q. I've never seen a file like this before. What characters am I allowed to use?
# A. This is a .yaml file. You are allowed to use most characters.
#    To test if your yaml is valid or not, you can use this website:
#        http://www.yamllint.com/
#    You can also verify that your Archipelago options are valid at this site:
#        https://archipelago.gg/check

# Your name in-game, limited to 16 characters.
#     {player} will be replaced with the player's slot number.
#     {PLAYER} will be replaced with the player's slot number, if that slot number is greater than 1.
#     {number} will be replaced with the counter value of the name.
#     {NUMBER} will be replaced with the counter value of the name, if the counter value is greater than 1.
name: Player{number}

# Used to describe your yaml. Useful if you have multiple files.
description: Default Dark Souls II Template

game: Dark Souls II
requires:
  version: 0.6.6 # Version of Archipelago required for this yaml to work as expected.

Dark Souls II:
  ################
  # Game Options #
  ################
  game_version:
    # Set the game version you will be playing on
    # 
    # - **sotfs:** You will be playing the Scholar of the First Sin version
    # - **vanilla:** You will be playing the Vanilla version
    sotfs: 50
    vanilla: 0

  sunken_king_dlc:
    # Enable Crown of the Sunken King DLC.
    'false': 50
    'true': 0

  old_iron_king_dlc:
    # Enable Crown of the Old Iron King DLC.
    'false': 50
    'true': 0

  ivory_king_dlc:
    # Enable Crown of the Ivory King DLC.
    'false': 50
    'true': 0

  #############
  # Equipment #
  #############
  no_weapon_req:
    # Remove the requirements to wield weapons
    'false': 50
    'true': 0

  no_spell_req:
    # Remove the requirements to cast spells
    'false': 50
    'true': 0

  no_armor_req:
    # Remove the requirements to wear armor
    'false': 50
    'true': 0

  no_equip_load:
    # Disable the equip load constraint from the game.
    'false': 50
    'true': 0

  randomize_equipment_level_percentage:
    # The percentage of weapons and armor in the pool to be reinforced.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    33: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-100: 0 # random value between 0 and 100

  min_equipment_reinforcement_in_5:
    # The minimum reinforcement level for equipment that can only reach +5.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 5
    1: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-1-5: 0 # random value between 1 and 5

  max_equipment_reinforcement_in_5:
    # The maximum reinforcement level for equipment that can only reach +5.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 5
    5: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-1-5: 0 # random value between 1 and 5

  min_equipment_reinforcement_in_10:
    # The minimum reinforcement level for equipment that can only reach +10.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 10
    1: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-1-10: 0 # random value between 1 and 10

  max_equipment_reinforcement_in_10:
    # The maximum reinforcement level for equipment that can only reach +10.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 10
    10: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-1-10: 0 # random value between 1 and 10

  ###################
  # Quality of Life #
  ###################
  infinite_lifegems:
    # Keep Melentia's infinite supply of lifegems unrandomized
    'false': 50
    'true': 0

  early_blacksmith:
    # Force Lenigrast's key into an early sphere in your world or across all worlds.
    anywhere: 0
    early_global: 0
    early_local: 50

  combat_logic:
    # Determines the distribution of Estus Flask Shards and Sublime Bone Dust.
    # Easy - Most shards/dust available fairly early on
    # Medium - Moderate amount of shards/dust available early in the game
    # Hard - There is minimal logical requirement for shards/dust to be available before the end of the game
    # Disabled - There is zero requirements for shards/dust anywhere; Lost Bastille is Sphere 1 in Scholar, and Sinners' Rise is Sphere 1 in vanilla.
    easy: 0
    medium: 50
    hard: 0
    disabled: 0

  ###########################
  # Item & Location Options #
  ###########################
  exclude_locations:
    # Prevent these locations from having an important item.
    []

  include_locations:
    # Only these locations may contain an important item.
    # This does the opposite of Excluded Locations.
    # If empty, no restriction is applied.
    []

  useful_items:
    # Items that will be marked as useful.
    # Useful items cannot be placed in excluded or unreachable locations.
    # Both individual item names and item categories can be used here.
    ['Boss Souls', 'Upgrade Materials']

  include_items:
    # Items that will be included in the item pool if there is space.
    # This can be helpful if you want to include an item that is not in logic by default.
    # Each item will only be added to the item pool once.
    []

  local_items:
    # Forces these items to be in their native world.
    []

  non_local_items:
    # Forces these items to be outside their native world.
    []

  start_inventory:
    # Start with the specified amount of these items. Example: "Bomb: 1"
    {}

  start_hints:
    # Start with these item's locations prefilled into the ``!hint`` command.
    []

  start_location_hints:
    # Start with these locations and their item prefilled into the ``!hint`` command.
    []

  priority_locations:
    # Prevent these locations from having an unimportant item.
    []

  item_links:
    # Share part of your item pool with other players.
    []

  plando_items:
    # Generic items plando.
    []
